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The  Event  Monitor  is  a  programmed  procedure  for 
dynamically  invoking  management  activities  to  be 
simulated  by  the  Prognosis  Model.  Activities  include 
simulated  thinnings,  harvesting,  plantings,  or  any 
other  activity  that  the  simulation  model  can  mimic. 
The  Event  Monitor  accepts  policy  statements 
expressed  as  conditions  to  be  met  and  a  set  of  activi- 
ties to  be  simulated  after  the  conditions  are  met. 
Thus,  policy  statements  may  be  evaluated  using  Prog- 
nosis Model  without  users  foretelling  the  development 
of  each  stand  in  an  analysis  and  manually  scheduling 
activities. 

The  Event  Monitor  enhances  control  of  the  Progno- 
sis Model  and  the  operation  of  several  model  exten- 
sions, notably  the  Regeneration  Establishment  Model 
and  the  Parallel  Processing  Extensions  (PPE).  As  a 
part  of  the  PPE,  the  monitor  can  generate  decision 
trees  of  management  alternatives. 
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User's  Guide  to  the  Event 
Monitor:  An  Addition  to  the 
Prognosis  IVIodel 

Nicholas  L.  Crookston 


INTRODUCTION 

The  decision  to  perform  a  management  activity  in  a  stand  is  often  contingent 
upon  several  factors.  Thinning  may  be  caEed  for  if  the  stand  is  too  dense,  or 
spraying  may  be  required  if  an  insect  population  is  causing  too  much  damage. 
Usually,  users  of  stand-growth  simulation  models  must  foretell  when  stand  con- 
ditions that  require  management  action  will  occur  and  preschedule  the  program 
options  that  represent  those  actions. 

The  Event  Monitor  offers  an  alternative  method  of  scheduling  activities:  You 
specify  a  set  of  conditions  that  must  occur,  or  thresholds  that  must  be  reached. 
During  the  simulation,  the  specified  conditions  are  monitored  and,  in  the  event 
they  occur,  the  management  activities  you  specify  are  scheduled.  For  example, 
suppose  you  wish  to  schedule  a  thinning  only  if  the  stand  crown  competition 
factor  (Krajicek  and  others  1961)  exceeds  150,  trees  per  acre  exceed  500,  and 
age  is  greater  than  20  and  less  than  60  years.  Using  the  Event  Monitor,  the 
conditions  are  specified  via  a  logical  expression  followed  by  the  activities 
(represented  by  Prognosis  Model  options)  that  are  to  be  invoked  when  that 
expression  is  true. 

Taken  together,  an  event  and  the  management  activities  may  be  viewed  as  a 
policy  statement.  Thus,  policy  statements  may  be  evaluated  using  Prognosis 
Model  without  users  foreteUing  the  development  of  each  stand  in  an  analysis 
and  manually  scheduling  activities. 

The  monitor  is  part  of  Version  5  of  the  Prognosis  Model  (Stage  1973;  Wykoff 
and  others  1982);  as  a  component  of  that  model,  it  serves  the  following 
purposes: 

•  Permits  the  inclusion  of  poUcy  statements  in  a  simulation  run.  Thus  empha- 
sis may  be  placed  on  the  specification  of  a  policy  appUcable  to  a  class  of 
stands,  rather  than  on  a  prescription  for  individual  stands. 

•  Offers  an  additional  mechanism  to  control  the  operation  of  extensions  to  the 
Prognosis  Model  such  as  the  Regeneration  EstabUshment  Model  (Ferguson 
and  Crookston  1984). 

•  Provides  a  way  to  create  decision  trees  within  the  Parallel  Processing  Exten- 
sion (Crookston  in  preparation).  Decision  trees  are  useful  for  systematically 
evaluating  the  response  of  forest  growth  to  random  catastrophic  events 
(insect  epidemics  or  forest  fires,  for  example)  and  alternative  management 
practices  given  equal  starting  conditions. 

Specific  examples  will  show  how  to  use  the  program.  The  rules  that  govern 
its  operation  are  impUcitly  presented  in  the  examples  and  then  explicitly 
presented  in  a  subsequent  section.  This  order  is  designed  to  give  you  a  general 
understanding  of  the  program's  use  before  you  are  presented  with  specific 


details.  How  you  apply  the  rules  to  your  own  problems  is  left  to  your  imagina- 
tion. Be  bold!  If  you  can't  find  an  example  that  meets  your  requirements, 
invent  one. 

I  assume  that  you  are  familiar  with  the  Prognosis  Model.  Terms,  operational 
rules,  and  concepts  explained  in  the  Prognosis  Model  user's  guide  (Wykoff  and 
others  1982)  are  used  here  without  explanation. 

USING  THE  EVENT  MONITOR 

Overview  An  event  is  designated  by  an  IF  keyword  record,  followed  by  a  logical 

expression.  The  expression  is  coded  on  one  or  more  supplemental  data  records. 
It  may  contain  constants,  arithmetic  operators,  parentheses,  relational  and 
logical  operators  (greater  than  (GT),  less  than  (LT),  equal  (EQ),  AND,  OR,  etc.), 
and  certain  variables.  Following  the  logical  expression,  a  THEN  keyword  record 
is  entered;  it  signals  the  end  of  the  logical  expression  and  the  beginning  of  the 
activities  that  will  be  scheduled  only  when  the  expression  is  true.  Any 
Prognosis  Model  keyword-option  (including  those  found  in  extensions)  that  can 
be  scheduled  by  entering  a  cycle  number  or  year  in  the  first  numeric  field  can 
be  scheduled  by  the  Event  Monitor.  The  value  in  Field  1  of  the  activity 
keyword  record  is  added  to  the  year  the  event  occurs,  the  sum  becomes  the 
year  the  activity  is  scheduled  to  occur.  An  END  IF  keyword  is  entered  to  signal 
that  normal  activity  processing  should  resume. 
IF,  THEN,  and  Example  1.— The  example  presented  in  the  Introduction  is  elaborated  on  in 

END  IF  the  context  of  a  complete  Prognosis  Model  keyword  file.  The  pohcy  for  this 

example  is  as  follows:  If  before-thinning  crown  competition  factor  (BCCF)  is 
greater  than  150,  before-thinning  trees  per  acre  (BTPA)  is  greater  than  500, 
and  age  is  greater  than  20  and  less  than  60,  then  thin  from  below  to  a  residual 
stand  density  of  300  trees  per  acre. 

Keyword  record 

Reference 


line 

K  e  y  w  0  r  d 

Field  1 

F  1  e  1  d    2  F 

i  e  1  d   3     Field  4 

Field  5 

Field  6 

Field  7 

1 

STAND  1 D 

2 

EXAMPLE1 

EVENT  MONI 

1  TOR  USER'S 

GUIDE    EXAMPLE  1 

3 

1  NVYEAR 

1  9  7  2. 

4 

NUMCYCLE 

1  0  . 

5 

1  F 

9  9  9  . 

6 

BCCF 

GT    15  0    AND  E 

3TPA   GT    5  0  0 

AND   AGE  & 

7 
8 

GT    2  0 
THEN 

AND   AGE  LT 

60 

9 

TH  1  NBTA 

0. 

3  0  0. 

1  0 

END  1  F 

1  1 

STD 1 NFO 

1  8  . 

7  10. 

10.                4  . 

5  . 

56  . 

1  2 

PROCESS 

1  3 

STOP 

Some  of  the  output  created  by  running  this  example  is  in  the  appendix; 
further  explanation  of  the  input  file  follows: 

Lines  1  and  2:  Enter  the  stand  identification  and  a  run  title. 

Line  3:  Specify  the  inventory  year. 

Line  4:  Specify  the  number  of  cycles. 

Line  5:  IF  signals  that  a  logical  expression  follows  and  that  the  minimum 
delay  time  between  responses  to  this  event  is  999  years. 
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Lines  6  and  7:  The  logical  expression  is  coded  "free  form"  (that  is,  characters 
need  not  be  placed  in  specific  columns)  on  one  or  more  supplemental  data 
records  that  follow  the  IF  keyword.  The  ampersand  ("&")  at  the  end  of  line  6 
signals  that  the  expression  is  continued  on  the  following  record. 

Line  8:  THEN  signals  that  the  activities  (options  specified  by  date  or  cycle) 
that  follow  will  not  be  scheduled  until  after  the  event  happens;  that  is,  when 
the  logical  expression  is  true. 

Line  9:  THINBTA  is  a  thinning  option  that  will  be  scheduled  in  the  same 
year  that  the  event  happens;  thus,  a  zero  is  coded  in  field  1.  The  residual  trees 
per  acre  are  coded  in  field  2. 

Line  10:  ENDIF  marks  the  end  of  the  conditionally  specified  options. 

Line  11:  Enter  data  specific  to  the  stand  such  as  the  forest  code. 

Line  12:  Signals  that  all  of  the  keywords  have  been  entered  and  that  the 
stand  should  be  processed. 

Line  13:  Stop  the  Prognosis  Model. 

Minimum  delay  time.— It  is  possible  to  specify  a  logical  expression  that  could 
remain  true  for  several  consecutive  cycles.  If  you  intend  to  schedule  a  response 
to  the  event  on  longer  intervals  than  each  succeeding  cycle,  you  may  enter  a 
minimum  number  of  years  between  responses  in  field  1  of  the  IF  keyword. 

Example  2.— This  example  illustrates: 

•  the  Event  Monitor's  use  with  the  Regeneration  EstabUshment  Model 
(Ferguson  and  Crookston  1984)  and,  by  impUcation,  other  Prognosis  Model 
extensions; 

•  that  more  than  one  activity  may  be  specified  after  a  THEN  keyword; 

•  that  more  than  one  policy  statement  may  be  specified;  and 

•  that  the  minimum  delay  time  can  be  set  to  control  the  frequency  at  which 
activities  are  scheduled. 

The  first  policy  statement  concerns  the  regeneration  harvest  guides  and  reads 
as  follows:  When  the  culmination  of  mean  annual  increment  (MAI)  is  reached, 
clearcut  the  stand,  broadcast  burn  the  next  year,  and,  in  the  second  year  after 
harvest,  plant  300  spruce  and  300  larch  per  acre.  The  date  of  culmination  is 
detected  by  monitoring  periodic  annual  increment  (PAI,  10-year  period)  and 
MAI.  When  periodic  annual  increment  (PAI)  is  less  than  MAI,  the  stand  has 
reached  culmination  of  MAI. 

The  second  policy  statement  concerns  scheduling  some  thinnings  to  control 
density:  When  the  stand  basal  area  (BBA)  exceeds  150  ft^  per  acre,  thin  from 
below  to  130  ft^.  These  thinnings  should  not  occur  more  frequently  than  every 
20  years. 
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The  keyword  file  used  to  run  this  example  is  listed  below;  output  is  in  the 
appendix. 


Keyword  record 

Reference 


line 

Keyword 

Field  1 

Field  2 

Fields     Field   4     Field   5     Field   6     Field  7 

1 

STANDI  D 

2 

EXAMPLE2 

EVENT   MONITOR  USER 

' S   GUIDE,     EXAMPLE  2 

3 

1 NVYEAR 

1  9  7  2. 

4 

N  UMC  Y  C  L  E 

1  5  . 

5 

1  F 

9  9  9. 

6 

PA  1    L  T  MAI 

7 

THEN 

8 

TH 1 NATA 

0  . 

0  . 

1  . 

9 

ESTAB 

1  0 
1  1 

BURNPREP 
MECHPREP 

1  . 
1  . 

80  . 
20  . 

1  2 

PLANT 

2  . 

2  . 

3  0  0.  90. 

1  3 

PLANT 

2  . 

8  . 

3  0  0.  90. 

1  4 

STOCKAD J 

9  . 

~1  . 

1  5 

RESETAGE 

0  . 

0  . 

1  6 

END 

1-7 
1  8 

END  1  F 

1  F 

2  0  . 

1  9 

BBA   GT  1  5  0 

AND    AGE    LT  130 

2  0 

THEN 

2  1 

TH  1  NBBA 

0  . 

13  0. 

2  2 

END  1  F 

2  3 

STD 1 NFO 

1  8  . 

6  8  0  . 

1  5  0.                8.                 5  .                  5  3  . 

2  4 

PROCESS 

2  5 

STOP 

Lines  1  to  4:  Like 

example  1. 

Line  5: 

Specify  that  the  logical  expression  follows  and  that  the  minimum 

delay  time  between  responses  to  this  event  is  999  years. 

Lines  6  and  7:  Specify  the  event:  IF  the  PAI  is  less  than  the  MAI.  THEN. 

Line  8:  The  management  activity  is  to  cut  (using  a  Prognosis  Model  thinning 
option)  all  of  the  trees.  Note  that  the  residual  stand  density  coded  in  field  2  is 
zero,  and  that  the  cutting  effectiveness  coded  in  field  3  is  1.0. 

Line  9:  Signals  the  Prognosis  Model  that  Regeneration  EstabUshment  Model 
options  foUow. 

Lines  10  through  15:  Specify  the  site  preparation  assumptions  and  the 
plantings.  Line  14  contains  a  command  that  limits  establishment  of  trees  to 
only  those  planted.  Line  15  causes  the  stand  age  to  be  reset  to  zero  years  (the 
number  coded  in  field  2).  Consult  Ferguson  and  Crookston  (1984)  for  a  complete 
description  of  these  keywords. 

Line  16:  Signals  the  Establishment  Model  that  Prognosis  Model  options 
follow. 

Line  17:  Signals  the  end  of  the  activities  that  will  only  be  scheduled  when 
PAI  is  less  than  MAI. 

Lines  18  to  22:  A  second  policy  is  entered  with  a  minimum  delay  time 
between  responses  set  to  20  years  (field  1  of  line  18).  The  before-thin  basal  area 
is  compared  to  150,  area  is  compared  to  130  (line  19),  and  a  thinning  from 
below  to  130  ft-  is  requested  in  line  21. 
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Generating  Decision  Decision  trees  are  used  to  evaluate  several  different  management  responses 
Trees  to  one  event.  For  a  description  of  this  and  other  applications  of  decision  trees 

see  Stage  (1975),  Talerico  and  others  (1978),  Crookston  (1978),  Stage  and 
others  (in  press),  and  the  Parallel  Processing  Extension  user's  guide  (PPE) 
(Crookston  in  preparation).  Because  the  creation  of  decision  trees  (fig.  1)  in  the 
PPE  is  controlled  by  the  Event  Monitor,  an  example  has  been  included  to  illus- 
trate how  to  use  the  PPE  and  the  Event  Monitor  together. 

The  branches  of  the  decision  tree  are  defined  by  specifying  more  than  one 
group  of  activities  following  a  single  logical  expression.  The  first  activity  (or 
activity  group)  foUows  the  THEN  keyword  record;  each  subsequent  group  of 
activities  follows  an  ALSOTRY  keyword  record.  Each  alternative  group  defines 
a  branch  of  the  decision  tree.  You  may  specify  one  to  nine  alternative  groups  of 
activities  for  each  event.  Remember,  this  option  may  only  be  used  with  the 
PPE. 


•  •  • 

CYCLE  CYCLE  IN  WHICH  CYCLE 

BEFORE  THE  EVENT  FOLLOWINQ 

EVENT  HAPPENS  THE  EVENT 

Figure  1.—The  decision  tree  generated  by  ttie  PPE  when  the  logical  expression 
in  example  3  is  true.  The  black  circle  is  the  node;  in  this  case  three  branches 
stem  from  the  node. 


Example  3:  ALSOTRY.— Let's  reconsider  example  1.  A  thinning  from  below 
to  300  trees  per  acre  will  be  scheduled  when  the  event  happens.  Using  the  PPE 
in  conjunction  with  the  Event  Monitor  you  may  ALSOTRY  another  alternative, 
say  thinning  from  below  to  400  trees  per  acre.  A  third  alternative  is  not  to  thin 
at  all.  The  PPE  simulates  and  reports  the  results  of  trying  all  three  alterna- 
tives. Keyword  records  needed  to  accomplish  this  objective  are  as  follows  (those 
needed  in  addition  to  example  1  are  at  lines  0.1,  9.1-9.3,  and  12.1-12.3): 
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Keyword  record 


Reference 

line  Keyword       Field    1        Field    2     Field   3     Field   4     Fields     Field   6  Field? 


0 

,  1 

ADDSTAND 

1 

STAND  1 D 

2 

EXAMPLES 

EVENT   MONITOR    USER'S   GUIDE    EXAMPLE  3. 

3 

1  NVYEAR 

1  9  7  2. 

4 

NUMCYCLE 

1  0. 

5 

1  F 

9  9  9. 

6 

BCCF 

GT    150    AND    BTPA   GT    500    AND   AGE  & 

7 

GT    2  0 

AND   AGE    LT  60 

8 

THEN 

9 

TH 1 NBTA 

0  .             3  0  0. 

9  , 

1 

ALSOTRY 

9  , 

2 

TH 1 NBTA 

0  .             4  0  0. 

9  , 

3 

ALSOTRY 

1  0 

END  1  F 

1  1 

1  1 

9  T  n  1  N  F  n 

10.                     1   \  \J  .                     lU.                           4.                           0.  OD. 

1  2 

PROCESS 

1  2  . 

1 

PROJ  EOT 

1  2  . 

2 

NOCOMPOS 

1  2  . 

3 

YIELDS 

13 

STOP 

Output  created  by  running  this  example  may  be  found  in  the  appendix. 

An  explanation  of  the  input  file  follows: 


Line  0.1:  ADDSTAND  is  a  PPE  keyword  that  signals  that  Prognosis  Model 
keywords  follow.  See  Crookston  (in  preparation)  for  an  additional  explanation. 

Lines  1  through  9:  Like  example  1. 

Line  9.1:  ALSOTRY  signals  that  another  group  of  activity  keywords  follows. 

Line  9.2:  THINBTA  is  entered  with  a  residual  of  400  trees  per  acre. 

Line  9.3:  Another  ALSOTRY  that  is  followed  immediately  by  an  ENDIF  sig- 
nals that  one  alternative  is  no  management. 

Lines  10  through  12:  Same  as  in  example  1. 

Line  12.1:  PROJECT  is  a  PPE  keyword  that  signals  that  all  of  the  stands  (in 
this  case  there  is  only  one  stand)  have  been  entered  and  the  projection  may 
start. 

Line  12.2:  NOCOMPOS  is  a  PPE  keyword  that  suppresses  the  calculation  of 
the  composite  yield  table. 

Line  12.3:  YIELDS  is  a  PPE  keyword  that  triggers  the  printing  of  the  yield 
statistics. 

Line  13:  Same  as  in  example  1. 

You  can  see  the  results  of  the  branching  and  scheduling  by  carefully  reading 
the  Activity  Summary  tables  printed  by  the  PPE  for  the  three  management 
alternatives  (output  is  in  the  appendix).  Each  summary  table  corresponds  to 
one  branch  of  the  decision  tree  (fig.  1).  The  Activity  Summaries  list  the  activi- 
ties that  were  scheduled  and  accompUshed  and  correspond  with  the  Summary 
Statistics  tables  printed  above  them.  Consult  Wykoff  and  others  (1982)  for  an 
additional  description  of  these  tables,  and  Crookston  (in  preparation)  for  a 
description  of  the  PPE. 
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Order  of 
Computations 


DETAILED  INSTRUCTIONS 

The  first  section  of  this  report  describes  the  purpose  and  potential  use  of  the 
Event  Monitor  and  its  position  within  the  Prognosis  Model.  The  following  sec- 
tion offers  additional  details  that  will  enable  you  to  make  full  use  of  the  Event 
Monitor. 

This  section  is  organized  as  follows:  a  keyword  summary  describes  the  key- 
words used  by  the  event  monitor.  A  section  titled  "Order  of  Computations" 
will  help  you  understand  how  the  order  of  calculations  within  the  Prognosis 
Model  influences  the  Event  Monitor.  The  rules  you  need  to  follow  when  coding 
logical  expressions  are  described  in  a  section  called  "Coding  Logical 
Expressions." 


Keyword  Summary  IF 


Signals  that  the  logical  expression  follows  on  one  or  more 
supplemental  data  records.  You  may  enter  several  poUcies  by 
entering  a  set  of  IF,  THEN,  activity  keywords,  and  an  ENDIF 
for  each  policy. 

Field  1:  The  minimum  waiting  time  before  the  event  may  happen 
again,  default  is  zero  years. 

THEN  Signals  that  the  activities  that  follow  will  be  scheduled  when  the 

event  happens.^ 

ALSOTRY    Used  in  conjunction  with  the  PPE  to  generate  decision  trees. 

Signals  that  a  second  or  subsequent  group  of  activities  foUow.^ 

ENDIF         Signals  the  end  of  a  set  of  Event  Monitor  keywords. 

Several  program  options  that  represent  activities  may  follow  one  THEN  or 
ALSOTRY  keyword.  (The  actual  number  depends  on  many  factors;  a  realistic 
upper  Umit  is  about  100.) 

Any  Prognosis  Model  options  that  may  be  scheduled  (that  is,  a  date  or  cycle 
is  entered  in  field  1  of  the  keyword  record),  may  alternatively  be  entered  as 
conditional  activities,  that  is,  they  may  follow  a  THEN  or  ALSOTRY. 
Prognosis  Model  options  that  do  not  contain  a  date  in  field  1  may  not  be  made 
conditional.  For  example,  a  NUMCYCLE  keyword  entered  between  a  THEN 
and  an  ENDIF  keyword  will  be  processed  normally. 

When  expressions  are  evaluated.— The  Event  Monitor  evaluates  all  logical 
expressions  at  each  of  two  different  times  during  a  growth  cycle  (see  fig.  1  in 
Wykoff  and  others  1982):  once  at  the  beginning  of  the  growth  cycle  prior  to 
thinnings,  and  once  after  thinnings.  Therefore,  a  logical  expression  that  tests 
on  before-thin  density  can  be  used  to  trigger  a  thinning  during  the  same  cycle. 

The  Regeneration  Estabhshment  Model  is  called  near  the  end  of  a  cycle. 
Thus,  it  is  possible  to  trigger  a  regeneration  tally  as  a  response  to  a  before-thin 
or  an  after-thin  density. 

You  can  schedule  a  thinning  in  response  to  detecting  that  a  thinning  has 
occurred.  However,  the  conditionally  scheduled  thinning  cannot  be  simulated 
during  the  same  cycle  the  event  is  detected  because  the  event  is,  itself,  another 
thinning.  You  can  specify  that  the  conditionally  scheduled  thinning  be  sched- 
uled 10  years  after  the  event  occurs  by  coding  "10"  in  field  1  of  the  desired 
thinning  keyword  record.  If  the  cycle  length  is  10  years,  the  conditionally 
scheduled  thinning  will  thus  be  simulated  in  the  following  cycle. 


'The  numeric  fields  on  the  THEN  and  ALSOTRY  keywords  are  reserved  for  future  use  by  the  PPE. 


7 


When  Event  Monitor  variables  are  defined.— The  variables  that  can  be  used 
in  logical  expressions  are  divided  into  four  groups  (table  1)  depending  on  when 
the  variables  are  defined.  If  any  variable  is  undefined  when  the  expression  is 
evaluated,  the  expression  is  deemed  false. 


Table  1.— Variables  that  can  be  used  within  logical  expressions 


Variable 
name 


Description 


YEAR 

AGE 

BTPA 

BTCUFT 

BMCUFT 

BBDFT 

BBA 

BCCF 

BCCFWP 

BCCFL 

BCCFDF 

BCCFGF 

BCGFWH 

BCCFC 

BCCFLP 

BGCFS 

BGCFAF 

BCGFPP 

BCCFOTR 

BTOPHT 

BADBH 

RANN 

YES 

NO 

NUMTREES 
CYCLE 


Group  1,  always  defined 

Beginning  year  of  a  cycle 
Age  at  beginning  of  a  cycle 


Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 
Before-th 


n  trees  per  acre 

n  total  cubic  foot  volume 

n  merchantable  cubic  foot  volume 

n  Scribner  board  foot  volume 

n  basal  area  per  acre 


n  crown  compet 
n  crown  compet 
n  crown  compet 
n  crown  compet 
n  crown  compet 
n  crown  compet 
n  crown  compet 
n  crown  compet 
n  crown  compet 
n  crown  compet 
n  crown  compet 


tion  factor 

tion  factor  for  white  pine 
tion  factor  for  larch 
tion  factor  for  Douglas-fir 
tion  factor  for  grand  fir 
tion  factor  for  western  hemlock 
tion  factor  for  western  redcedar 
tion  factor  for  lodgepole  pine 
tion  factor  for  spruce 
tion  factor  for  alpine  fir 
tion  factor  for  ponderosa  pine 
tion  factor  for  other  species 


in  crown  compet 
in  average  top  height 
in  quadratic  mean  d.b.h. 
A  random  number  between  0  and  1 
The  constant  1. 
The  constant  0. 

Number  of  tree  records  stored  by  the  model 
Cycle  number 

Group  2,  defined  only  after  thinning  each  cycle 


ATPA 

After- 

thin 

ATCUFT 

After- 

thin 

AMCUFT 

After- 

thin 

ABDFT 

After- 

thin 

ABA 

After- 

thin 

ACCF 

After- 

thin 

ACCFWP 

After- 

thin 

ACCFL 

After- 

thin 

ACCFDF 

After- 

thin 

ACCFGF 

After- 

thin 

ACCFWH 

After- 

thin 

ACCFC 

After- 

thin 

ACCFLP 

After- 

thin 

ACCFS 

After- 

thin 

ACCFAF 

After- 

thin 

ACCFPP 

After- 

thin 

ACCFOTR 

After- 

thin 

ATOPHT 

After- 

thin 

AADBH 

After- 

thin 

RTPA 

Removed 

RTCUFT 

Removed 

Rf^^BDFT 

Removed 

tion  factor 

tion  factor  for  white  pine 

tion  factor  for  larch 

tion  factor  for  Douglas-fir 

tion  factor  for  grand  fir 

tion  factor  for  western  hemlock 

tion  factor  for  western  redcedar 

tion  factor  for  lodgepole  pine 

tion  factor  for  spruce 

tion  factor  for  alpine  fir 

tion  factor  for  ponderosa  pine 

tion  factor  for  other  species 


(con.) 
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Table  1.  (Con.) 


Variable 


name 


Description 


ACC 

MORT 


DBA 


DCCF% 


MAI 

DTPA 


DCCF 


DTPA% 


DBA% 


PA  I 


Group  3,  defined  when  cycle  2  starts 

Accretion  from  last  cycle,  cubic  feet/acre/year 
Mortality  from  last  cycle,  cubic  feet/acre/year 
Periodic  annual  increment  last  cycle,  cubic  feet  per  acre 
Mean  annual  increment  last  cycle,  cubic  feet 
Number  of  trees  per  acre  at  the  beginning  of  current  cycle 
minus  the  number  at  the  beginning  of  previous  cycle 
Trees  per  acre  at  the  beginning  of  current  cycle  divided  by 
the  number  at  the  beginning  of  previous  cycle;  then  multi- 
plied times  100 

Basal  area  per  acre  at  the  beginning  of  current  cycle  minus 
the  basal  area  at  the  beginning  of  previous  cycle 
Basal  area  per  acre  at  the  beginning  of  current  cycle  divided 
by  the  basal  area  at  the  beginning  of  previous  cycle;  then 
multiplied  times  100 

Crown  competition  factor  at  the  beginning  of  current  cycle 
minus  the  factor  at  the  beginning  of  previous  cycle 
Crown  competition  factor  at  the  beginning  of  current  cycle 
divided  by  the  factor  at  the  beginning  of  previous  cycle; 
then  multiplied  times  100 


TM%DF 
TM%GF 


TM%STND 


Group  4,  defined  by  extensions  to  the  Prognosis  Model 

)      The  stand  average  tree  defoliation  level  caused  by  the 
Douglas-fir  tussock  moth  during  the  previous  cycle 
(Monserud  and  Crookston  1982) 
The  average  tree  defoliation  on  Douglas-fir 
The  average  tree  defoliation  on  grand  fir 


MPBTPAK       The  number  of  trees  per  acre  killed  by  the  mountain  pine 

beetle  during  the  previous  cycle 
BW%STND     The  stand  defoliation  level  caused  by  the  western  spruce 

budworm  during  the  previous  cycle 
SELECTED      Takes  on  the  value  YES  if  the  stand  has  been  selected  for 

harvest  by  the  PPE's  harvest  allocation  logic.  The  value  is 

NO  if  the  stand  has  not  been  selected. 


Variables  listed  in  group  1  are  always  known;  you  can  include  them  in  logical 
expressions  either  by  themselves  or  with  those  Listed  in  the  other  groups. 

Group  2  variables  are  only  known  after  thinning.  They  are  correctly  defined 
even  though  no  thinnings  are  done  in  a  given  cycle,  but  they  are  undefined 
when  the  Event  Monitor  evaluates  expressions  prior  to  thinnings  each  cycle. 

Group  3  variables  are  not  defined  until  after  the  first  cycle.  For  example,  the 
stand  accretion  is  computed  after  the  second  time  the  Event  Monitor  evaluates 
logical  expressions  each  cycle.  Therefore,  the  stand  accretion  variable  is 
assigned  the  accretion  from  the  previous  cycle.  Variables  that  measure  change, 
such  as  DBA  (delta  basal  area,  the  change  in  based  area  from  cycle  to  cycle), 
are  computed  by  the  monitor  by  subtracting  the  value  stored  from  the  previous 
cycle  from  the  current  value.  These  variables  are  also  undefined  until  the  begin- 
ning of  the  second  Prognosis  Model  cycle.  After  the  second  cycle  starts,  group 
3  V8iriables  can  be  used  any  time. 

Group  4  variables  are  assigned  values  by  Prognosis  Model  extensions.  The 
value  of  these  variables  remains  unknown  unless  the  appropriate  extension  is 
being  used. 
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Logical  expressions  consist  of  variables  (table  1),  constants,  parentheses,  and 
logical  and  arithmetic  operators  (table  2).  When  coding  logical  expressions,  fol- 
low these  rules: 

•  Variable  names,  constants,  and  function  names  must  be  separated 
from  logical  operators  by  one  or  more  blanks  or  parentheses. 

•  A  parenthesis,  constant,  or  variable  must  separate  two  arithmetic  operators: 
AGE*-2.5  is  invalid,  AGE*(-2.5)  is  valid, -2.5*AGE  is  also  valid. 

•  Operators  are  executed  in  order  of  precedence  given  in  table  2,  or  parentheses 
may  be  used  to  control  the  precedence  of  evaluation. 

•  When  equally  ranked  operations  are  found,  evaluation  proceeds  from 
left  to  right. 

•  Constants  are  treated  as  floating  point  numbers  whether  or  not  a  decimal 
point  is  coded.  A  value  coded  as  an  integer  is  converted  to  floating  point  by 
adding  decimal  point:  300  is  converted  to  300.0. 

•  An  ampersand  (&)  signals  that  the  expression  is  continued  on  the  next  Une. 
Characters  that  follow  the  ampersand  are  ignored  and  may  be  used  to  enter 
comments. 

The  following  are  valid  (and  equivalent)  expressions: 

(BTPA*2  GE  1000  OR  AGE  GT  50.) 

(NOT  BTPA  LT  500)  OR  (NOT  AGE  LE  50.0) 

NOT  (BTPA  LT  500  AND  AGE  LE  50) 

The  following  are  invalid: 

(ATPA  .LT.  500.)— the  inclusion  of  the  periods  before  and  after  the  less-than 
operator  is  valid  in  FORTRAN  but  not  in  the  Event  Monitor. 
(NOT  ((BTPA  LT  50))— unbalanced  parentheses. 

Table  2.  — Operators  that  can  be  used  in  logical  expressions 
Precedence^     Operator  Description  Example  of  usage 


Arithmetic  functions 


1  ^' 

SORT 

Square  root 

SQRT(A) 

1  ^' 

EXP 

e  raised  to  power  A 

EXP(A) 

1  ^' 

ALOG 

Natural  logarithim 

ALOG{A) 

1  ^' 

ALOG10 

Common  logarithm 

ALOG10(A) 

1  ^' 

INT 

Truncate  fractional  part^ 

INT(A/B) 

1  ^' 

FRAG 

Truncate  integer  part-' 

FRAC(A/B) 

Aritfimetic  operators 

2nd 

Change  sign 

-A 

3rd 

Exponentiate 

A**B 

4th 

Multiply 

A*B 

4th 

/ 

Divide 

A/B 

+ 

Add 

A  +  B 

5'^ 

Subtract 

A-B 

Logical  operators 

gth 

EQ 

Equal 

A  EQ  B 

gth 

NE 

Not  equal 

A  NE  B 

glh 

LT 

Less  than 

A  LT  B 

glh 

GT 

Greater  than 

A  GT  B 

glh 

LE 

Less  than  or  equal 

A  LE  B 

glh 

GE 

Greater  than  or  equal 

A  GE  B 

7ih 

NOT 

Logical  not 

NOT  (A  GT  B) 

glh 

AND 

Logical  and 

(A  GT  B)  AND  (A  LT  C) 

gth 

OR 

Logical  or 

(A  GT  B)  OR  (A  LT  C) 

'Operators  are  executed  in  order  of  precedence  wittiin  parenttietical  groups.  For  example 
consider  ttie  following:  ALOG(A)' ■2.  +  5/C,  ttie  log  is  taken  first,  the  result  is  raised  to  the 
power  of  2,  then  5  is  divided  by  C  and  added  to  the  previous  result. 

^For  example;  INT(3.4)  is  equal  to  3.0. 

^For  example:  FRAC(3.4)  is  equal  to  0.4. 
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SUMMARY 

Using  the  Event  Monitor,  logical  relations  between  stand  variables  generated 
by  the  Prognosis  Model  can  be  evaluated  during  the  simulation.  When  the  logi- 
cal relation  is  true,  activities  which  the  model  is  capable  of  simulating  will  be 
invoked. 

This  document  describes  how  to  use  the  Event  Monitor  to  schedule  Prognosis 
Model  options  such  as  thinnings  and  Establishment  Model  options  and  how  to 
create  decision  trees  using  the  PPE. 
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Crookston,  Nicholas  L.  User's  guide  to  the  Event  Monitor:  an  addition  to  the 
Prognosis  Model.  General  Technical  Report  INT-196.  Ogden,  UT:  U.S.  Depart- 
ment of  Agriculture,  Forest  Service,  Intermountain  Research  Station; 
1985.  36  p. 

Describes  how  to  use  the  Event  Monitor  for  scheduling  Prognosis  Model 
(Wykoff  and  others  1982)  and  Establishment  Model  (Ferguson  and  Crookston 
1984)  options,  and  for  creating  decision  trees  using  the  Parallel  Processing 
Extension  (Crookston  in  preparation).  The  program  monitors  certain  statistics 
within  the  Prognosis  Model  and,  when  specified  values  are  reached,  schedules 
options  that  represent  management  activities. 


KEYWORDS:  simulation,  forest,  management,  policy,  growth 


The  Intermountain  Research  Station,  headquartered  in  Ogden, 
Utah,  is  one  of  eight  Forest  Service  Research  stations  charged  with 
providing  scientific  knowledge  to  help  resource  managers  meet  human 
needs  and  protect  forest  and  range  ecosystems. 

The  Intermountain  Station's  primary  area  includes  Montana,  Idaho, 
Utah,  Nevada,  and  western  Wyoming.  About  231  million  acres,  or  85 
percent,  of  the  land  area  in  the  Station  territory  are  classified  as 
forest  and  rangeland.  These  lands  include  grasslands,  deserts, 
shrublands,  alpine  areas,  and  well-stocked  forests.  They  supply  fiber 
for  forest  industries;  minerals  for  energy  and  industrial  development; 
and  water  for  domestic  and  industrial  consumption.  They  also  provide 
recreation  opportunities  for  millions  of  visitors  each  year. 

Several  Station  research  units  work  in  additional  western  States,  or 
have  missions  that  are  national  in  scope. 

Field  programs  and  research  work  units  of  the  Station  are  maintain- 
ed in: 

Boise,  Idaho 

Bozeman,  Montana  (in  cooperation  with  Montana  State 
University) 

Logan,  Utah  (in  cooperation  with  Utah  State  University) 

Missoula,  Montana  (in  cooperation  with  the  University  of 
Montana) 

Moscow,  Idaho  (in  cooperation  with  the  University  of  Idaho) 
Ogden,  Utah 

Provo,  Utah  (in  cooperation  with  Brigham  Young  University) 
Reno,  Nevada  (in  cooperation  with  the  University  of  Nevada) 


